home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / fview610.zip / FVIEW.DOC < prev    next >
Text File  |  1993-01-04  |  14KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       FVIEW.EXE 
  8.                                     Version 6.00
  9.                                      May 17, 1989
  10.  
  11.                              Copyright 1989, Doug Boone
  12.  
  13.           FVIEW is  not  for sale.  If  you'd like  to make  a  _voluntary_
  14.           donation to the author, please do. FVIEW is not to be included in
  15.           any  commercial package, nor  can you charge  anyone anything for
  16.           distribution. If you paid someone for  this program, both you and
  17.           I were ripped  off, so let's get  together and go get  the person
  18.           who sold it to you!
  19.  
  20.           This is an attempt to deal with the proliferation of file archive
  21.           formats that are coming out  right now. It provides a  listing of
  22.           the contents  of SEA  <tm> ARC  <tm> files,  PKWARE's ZIP  files,
  23.           NoGate's PAK files, Dean Cooper's DWC files and Rahul Dhesi's ZOO
  24.           files. It  will also allow users to list  the text in those files
  25.           online, provided the  files are SEA  <tm> ARC <tm> compatible  or
  26.           PKZIP  files.  PAK.EXE  and  PKZIP.EXE   are  hard-coded  as  the
  27.           unpackers so they  must be available in the PATH for this program
  28.           to work. 
  29.  
  30.           *****************************************************************
  31.  
  32.           There  is nothing  "political"  about my  choices of  programs to
  33.           shell for FVIEW.EXE. My reasons are:
  34.  
  35.           1)   Zoo unpacks to  the local directory, you can't redirect  it.
  36.           Since  FVIEW  has  to reside  in  the  directory  where all  your
  37.           SYSTEM*.BBS files are, and USER.BBS  is probably there, unpacking
  38.           files to this directory  would be terrible. FVIEW always  deletes
  39.           the files  it unpacks after the user reads  them, but you can see
  40.           how this  would be a problem. If  you know how to  get ZOO.EXE to
  41.           unpack to another directory, send my Email to explain it and I'll
  42.           add ZOO handling.
  43.  
  44.           2)NoGate's PAK.EXE will  unpack any SEA<tm>'s ARC<tm>  files, but
  45.           SEA<tm>'s ARC<tm> can't unpack all the files  created by NoGate's
  46.           PAK  program.  FVIEW reads  the file  headers  to find  out which
  47.           unpacker to use, it doesn't look at file names, and  both SEA<tm>
  48.           and NoGate use  the same file header  so I can't tell  them apart
  49.           until  you actually  get to  the point  where you'd get  an error
  50.           message about an unrecognized packing method.
  51.  
  52.           3)The only other MS-DOS archive format I know of is Dean Cooper's
  53.           DWC, however,  I don't  see any DWC  files floating  around so  I
  54.           didn't think it was worth putting in. If you use DWC  files, send
  55.           Email and I can fix up a special version for you.
  56.  
  57.           4)There are other operating system  archiving systems, however no
  58.           one has ever been  able to explain what the file  format is like.
  59.           If anyone ever sends  my some documentation on them,  I'll try to
  60.           add them. 
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.           ** Opus 1.03 does NOT pass any parameters to the program. All the
  75.           ** hard-coded sections have to be used. FVIEW MUST be in the same
  76.           ** directory as your SYSTEM*.BBS files!
  77.  
  78.           The command line options are very simple:
  79.             
  80.           -Bbaud#   (Supplied by Opus)
  81.           -Ttask#   (Supplied by Opus)
  82.           -Pport#   (Supplied by Opus)
  83.  
  84.           -LFview_Log        Shows  user   activity.  DO  NOT  INCLUDE  THE
  85.           EXTENSION!!
  86.           -W             Use FOSSIL watchdog.
  87.           -DTemp_path    Path where unarchived files will go.
  88.           -SSystem_Path  Path to SYSTEM*.BBS and LASTUS*.BBS.
  89.           -N             Don't allow users to read files online.
  90.           -G             Extended debugging to LOG file.
  91.  
  92.           The defaults are:
  93.                Task      1
  94.                Port      0
  95.                Baud      2400
  96.                Log       FVIEW
  97.                Running Opus 1.10 beta/gamma
  98.                C:\Dearc\ as the temporary path.
  99.  
  100.           The ERRORLEVEL of the exits are:
  101.             
  102.                0    Normal, no problems
  103.                1    Can't find LASTUSER.BBS file.
  104.                2    Can't find SYSTEM*.BBS file.
  105.                3    User dropped carrier.
  106.             
  107.           Except   for   the  "-W"   and   the  "-DTemp_path",   Opus  will
  108.           automatically  provide  these when  it  runs  the  program, so  I
  109.           suggest you DON'T include them.  If you include the Port#  or the
  110.           Baud#, FVIEW will  think its  running remotely and  will exit  if
  111.           you're running  it  from keyboard  because  it will  detect  that
  112.           there's no carrier. 
  113.             
  114.           Regarding "-DTemp_path":
  115.           --------- --------------  
  116.           This is  where unarchived files for  users to read will  go. They
  117.           are created  by shelling  the appropriate program,  and then  the
  118.           files  are deleted  as  soon as  the user  is done  listing them.
  119.           That's why  you can  use wildcards  when listing  the members  of
  120.           archives,  but  not when  picking which  text  file to  list. The
  121.           default is C:\DEARC\.   THIS MUST BE A  BLANK DIRECTORY FOR  YOUR
  122.           SAFETY!! FVIEW will over-write  any existing files with the  same
  123.           name.  If your task  number is greater than  1, FVIEW will unpack
  124.           files to a sub-directory  of the Temp_Path named after  the task.
  125.           For example, if  you use C:\Dearc as your temp_path and a user is
  126.           on Task 4, Fview will unpack the temporary files to C:\Dearc\04\.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           If  that  directory does  not exist  the log  will show  an error
  140.           message, ERROR Reading (temp_dir\member) from (Source file). This
  141.           was done to prevent any collisions among multi-line systems.
  142.  
  143.  
  144.           In my control file, all I have is:
  145.             
  146.           _OUTSIDE  Disgrace "Kontents" = RUN C:\Opus\Fview.Exe -dc:\dearc\
  147.             
  148.           Opus automatically provides  the rest of the command options, and
  149.           actually, since I  use the default  C:\DEARC\, I don't need  even
  150.           that one the command line. 
  151.             
  152.           Users will only  get 5 minutes to  use FVIEW, then the  next time
  153.           they hit a menu or a More?  prompt, FVIEW will exit and return to
  154.           Opus. If  a user  drops carrier,  FVIEW returns  to Opus,  unless
  155.           you've used the "-W" option to turn on the FOSSIL Watchdog.
  156.  
  157.  
  158.           If you'd like  to send  questions, comments, improvements,  code,
  159.           contributions or whatever, I can be  reached any of the following
  160.           ways.
  161.  
  162.                                         Doug Boone
  163.                                         119/5
  164.                                         (916) 893-9019 (data)
  165.                                         (916) 891-0748 (voice)
  166.                                         P.O. Box 5108, Chico, CA, 95928
  167.  
  168.  
  169.           2-23-89 01.01
  170.             
  171.           Fixups to make this program work with Opus 1.03. Got out of touch
  172.           with how 1.03 works. It doesn't  pass any control line parameters
  173.           to the running  program except the  baud/port and a control  file
  174.           name. The task  number has to  be picked out of  the name of  the
  175.           control file.  That means that you  can't change the  name of the
  176.           log file,  whether or  not users  can read  files online, or  the
  177.           directory where files  are unpacked for users to read  if you run
  178.           Opus 1.03b. Sorry about that.
  179.  
  180.           March 2, 1989
  181.            
  182.           Fixed bug with  Opus 1.03 systems and  areas > 9. Opus  1.10 uses
  183.           Hexadecimal area numbers  and FVIEW was  too. Now it switches  to
  184.           decimal when  it knows that  its working with  Opus 1.03b.   Also
  185.           added the ability to handle wildcards  inside archives, so that a
  186.           user  doesn't have  to  have  an exact  match  for a  file  name.
  187.           However, I've only figured out how to handle '*'-type  wildcards,
  188.           no '?' wild-card  matching has been added yet. I'll  work on that
  189.           next, but  I wanted to get this released  to fix the problem with
  190.           hexadecimal area numbers.  There are  some other  (I think)  nice
  191.           additions, but  they're too complicated  to explain.  Try it  and
  192.           see.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.           March 2, 1989 (3.10)
  207.  
  208.           Added ^S  checking. Any  key after  a ^S will  start FVIEW  going
  209.           again.  Added more carrier checks in case  user hangs up while in
  210.           some intense  searches.  Added  -SSystem_Path  to  command  line.
  211.           Should make it possible to run  FVIEW from directories other than
  212.           where the SYSTEM*.BBS files are in Opus 1.10. Opus 1.03  does NOT
  213.           pass any parameters to FVIEW so don't use this with 1.03. Instead
  214.           keep FVIEW.EXE in  the same directory  as your SYSTEM*.BBS  files
  215.           are in.
  216.  
  217.           March 8, 1989 (4.00)
  218.            
  219.           Added  support for  configuration file,  FVIEW.CFG.  FVIEW.EXE is
  220.           hardcoded  for  that  name.   If  you  don't  like   the  default
  221.           configuration of FVIEW and are using  Opus 1.03b, you can now use
  222.           the CFG file to stick  in what would be  on the command line  for
  223.           1.10. Check out the CFG file for more information.
  224.  
  225.           March 9, 1989 (4.10,4.20)
  226.  
  227.           Added environment support. Opus  1.03b users can now use  a "SET"
  228.           statement in their  autoexec.bat file to handle  most (except for
  229.           baud, task, and  port) of  the command line  options without  any
  230.           command-line options  or configuration  file. Just  add something
  231.           like this to your autoexec.bat:
  232.             
  233.           Set fview=-dd:\dearc -g
  234.             
  235.           (Use d:\dearc for  temporary storage while  users read text  from
  236.           archives,  full debugging  information  logged. Remember  not  to
  237.           leave any spaces before or after the '=' sign!)
  238.             
  239.           The order of precedence when running fview is: 
  240.                1) Environment 
  241.                2) Config file 
  242.                3) Command line. 
  243.  
  244.           That is, the command line  is read, then if a configuration  file
  245.           exists  it  is  read,  and  then  if  there's  a  "FVIEW" in  the
  246.           environment, that will be read.  
  247.  
  248.           March 29, 1989 (4.30)
  249.  
  250.           Increased  the number  of  files that  you  can view  out of  one
  251.           archive to 256.  Hopefully no one's going to  exceed that! If you
  252.           run out, it  still should  be safe, earlier  versions were  doing
  253.           weird things if the count they used (64) was exceeded. (Thanks to
  254.           Glen Strecker (390/2)  and John Souvestre (390/101)  for pointing
  255.           out the trouble.)
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.           April 13, 1989 (5.00)
  272.  
  273.           Added support for LZH (Lharc.Exe) files. I don't know how popular
  274.           these are or  will be, but  FVIEW can list  the contents of  them
  275.           now.  However, Lharc  is  another  program  that  only  puts  the
  276.           contents of the archive in the local directory.  Also fixed a bug
  277.           in the validation of file names.
  278.  
  279.           May 8, 1989  (5.10)
  280.  
  281.           Changed the start-up code  so only users with NOVICE  help levels
  282.           have to go  through the opening help  screen. The help screen  is
  283.           available to everyone by typing in a "?" or "H"  or "HELP" to any
  284.           prompt.  Cleaned  up the section that gets a string from the user
  285.           so it will handle backspaces better.
  286.  
  287.           May 17, 1989  (6.00)
  288.  
  289.           Added code  (UNZIP.C by Samuel H. Smith)  to get past the problem
  290.           of  users  embedding  ANSI commands  inside  ZIP  archive comment
  291.           fields. Since PKUNZIP is  no longer being called, the  comment is
  292.           never unpacked, there won't  be any danger. Also have  added code
  293.           to handle PAK/ARC files. Pretty good, only adds 10k of EXE space.
  294.           Also, I'm  not really thrilled  with the UNZIP  code, so  I'll be
  295.           working  on  something  else, using  UNZIP.C  was  just a  quick,
  296.           temporary solution. (It should also allow  you to operate in less
  297.           memory with ZIP files, as we aren't shelling yet another program.
  298.  
  299.           Anyone got any GOOD  source code (not SEA's stuff)  for unpacking
  300.           ARC-style archives?  I  cheated and  used the  stuff from  NoGate
  301.           Consulting, but  it would be  much nicer if  it included ALL  the
  302.           source here. Check the  MAKEFILE files for information on  how to
  303.           compile  this  program  without  the  GROW.OBJ,  UTILITY.OBJ  and
  304.           COMPRESS.H files from NoGate Consulting.
  305.  
  306.           Now to go after ZOO and LZH!
  307.  
  308.  
  309.           NOTE:
  310.           -----
  311.             
  312.           I have  never received  any reward  for programming  Opus/FidoNet
  313.           utilities except for  the friendship and  respect of many  people
  314.           inside FidoNet. I am not asking for anything other than that. But
  315.           you should realize that I am now trying to maintain over  a dozen
  316.           programs  for the  Opus Sysop,  plus my  responsibilities  to the
  317.           MEADOW, Opus 1.10, and so on. The amount of time I  can devote to
  318.           this or  any other  program isn't  that great,  and the  hardware
  319.           resources are also limited. (Want color? Send EGA. :-)  Want more
  320.           mult-user operations? Send machine/memory/multi-tasker/modems...)
  321.           Want some spiffy new feature?  Send code.  
  322.                                              Thank You.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.